home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / smpsqzpr.zip / READ.ME < prev    next >
Text File  |  1990-06-26  |  5KB  |  120 lines
  1.                        SIMPLE SQUEEZE PRINT
  2.  
  3.      The versions of this program listed below are placed in the 
  4. public domain, without any warranty against damage to user's 
  5. equipment, paper, data, or software, or any thing that is the user's.
  6.  
  7.      If in doubt, read the instructions.
  8.  
  9.      One of the most useful programs for PC users is Paul Dawson's 
  10. Squeeze Print, which produces highly compressed printouts of ASCII 
  11. files on an Epson-compatible printer.   I found in practice that I 
  12. only wanted to use one format (160 characters wide, double column, 
  13. four 66-line blocks to a page), and I wanted:
  14.  
  15. 1. a version which would run under TRSDOS 6.x, CP/M, and generic 
  16. MS-DOS as well as PC-DOS;
  17.  
  18. 2. a form feed at the end of every page, so that the printout did 
  19. not overrun the perforations on tractor-feed paper;
  20.  
  21. 3. to print long lines without their being truncated or 
  22. overprinting the second column;
  23.  
  24. 4. to print several files in a single run;
  25.  
  26. 5. a version which would not grab too much memory when run on a PC 
  27. under multi-tasking utilities.
  28.  
  29. Simple Squeeze Print is the result. It still requires an 
  30. Epson-compatible printer.
  31.  
  32. The MS-DOS ZIP archive includes the following:
  33.  
  34.    Name           Length      Date    Time   CRC-32  
  35.    ----           ------      ----    ----   ------  
  36. 1. SMPSQZGW.BAS     2845    26-06-90  10:26  256f74f0
  37. 2. SMPSQZM2.EXE    17920    26-06-90  10:17  fcda01eb
  38. 3. SMPSQZPR.EXE    17792    26-06-90  10:19  4c1dd1df
  39.      -------        -------                           
  40.           3         38557                                 
  41.                                                                                 
  42. 1 is a GWbasic version which should run on any PC clone.
  43. 3 is the standard version for Generic MS-DOS, including PCs.
  44. 2 is a version to cope with extra long lines (more than 255 
  45. characters).
  46.  
  47. Do not LZEXE the EXE files; they won't run properly.
  48.  
  49. The program is very basic (no pun intended): there's not much 
  50. error checking; there are no command-line switches; it won't 
  51. display the directory or allow you to tag files to be printed: you 
  52. have to type the names in at the prompt.   Up to ten files may be 
  53. printed in one run; there will be a form feed at the end of each 
  54. file.   If you want the printout to run on without a page break at 
  55. the end of each file, unite the files with a text editor before 
  56. printing them.
  57.  
  58.  
  59.                       SOME POSSIBLE PROBLEMS
  60.  
  61. 1. Non-ASCII files
  62.  
  63.      Simple Squeeze Print is NOT designed to print fancy 
  64. word-processor files with embedded control strings, or any other 
  65. non-ASCII text files.    Such files will cause the printer to behave 
  66. unpredictably and will probably waste paper.   Files should be pure 
  67. ASCII and each line of text should end with a carriage return - 
  68. line feed sequence (on TRSDOS 6.x, a carriage return only). 
  69. SMPSQZM2.EXE provides for files which end lines consistently with 
  70. EITHER a carriage return, OR a line feed, OR both, but no version 
  71. can handle buckshee carriage returns and line feeds predictably.
  72.  
  73. 2. Line and Column wrapping
  74.  
  75.      All versions should wrap lines of between 80 and 255 characters 
  76. so that text is not lost.   This is character wrapping, not word 
  77. wrapping, so that words may be broken at the ends of lines of the 
  78. printout.   There is no guarantee that long lines will wrap 
  79. correctly if they happen to fall at a break between upper and 
  80. lower blocks on the page, or across page breaks, on the printout. 
  81. If the text ends in a left-hand column, that column will be 
  82. shortened and the text balanced across two columns.   If the text 
  83. ends in a right-hand column, the columns won't balance.
  84.  
  85.     Some early versions would, when more than one file was printed
  86. and one of the later files ended in balanced columns, print a couple
  87. of lines from an earlier file at then end of the later one.
  88. I hope that I have fixed this in this release.   If I haven't, please
  89. let me know.
  90.  
  91. 3. Very long lines
  92.  
  93.      The behaviour of all versions when trying to print files with 
  94. lines longer than 255 characters is unpredictable:
  95.  
  96.      a. The GWbasic, TRSDOS, and CP/M versions will probably break 
  97. the line at the 255th character and start a new line ranged left.
  98.  
  99.      b. The standard generic MS-DOS version (SMPSQZPR.EXE) will 
  100. CRASH HORRIBLY at an UNPREDICTABLE point in the process (which may 
  101. make you think there is something wrong with your hardware, or 
  102. that you've got a virus).   This is owing to a nasty bug in the 
  103. M*CR*S*FT compiler which I had to use.   If such a crash happens, try 
  104. SMPSQZM2.EXE instead.
  105.  
  106.      c. The alternative generic MS-DOS version (SMPSQZM2.EXE) 
  107. should get round this problem, though it may not cope with lines 
  108. which happen to fall across a block or page break.   You will have 
  109. to choose between using a carriage return or a line feed as the 
  110. line-end delimiter; if all lines end with CRLF you can choose 
  111. either without loss of text (except perhaps at a block break). 
  112. This program is a little slower than the standard version: don't 
  113. be alarmed if text doesn't start to appear instantly.
  114.  
  115. I hope that someone finds Simple Squeeze Print useful.
  116.  
  117.                                                 Christopher Currie
  118.                                                    20, 26 June 1990
  119.  
  120.